home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / ste / sam_seq.lzh / SAM_SEQ / READ_ME.DOC next >
Text File  |  1994-08-27  |  28KB  |  668 lines

  1. STE ONLY - STE ONLY - STE ONLY - STE ONLY - STE ONLY - STE ONLY
  2.  
  3. !!!!! THIS WILL NOT WORK ON AN STFM !!!!!
  4.  
  5. **************************************************************
  6. If you don't want to read this text please at least read the last bit, 
  7. especially if you have a HARD DISK !!! (under Hints) 
  8.  
  9. STEreo Sampled Sound Sequencing System.
  10. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  11. By Ian Hancock. PHAZE Shifters.
  12. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  13. © NOVEMBER:1992.
  14.  
  15. IT HELPS IF YOU READ THIS IN
  16. AT LEAST MEDIUM RESOLUTION.
  17.  
  18. A bit of a manual for the sequencer !!
  19.  
  20.      Introduction:
  21.  
  22.      What  started  out as a simple method of playing  one  sample 
  23. after  another for my own benefit turned,  into a reasonably  well 
  24. featured (but still simple enough) Sound Sample Sequencer.  I must add 
  25. at this point the sequencer and BASIC code blocks ONLY WORK ON THE 
  26. ATARI STE this is because the STFM does not have the 2-channel stereo, 
  27. Direct Memory Access, Digital to Analog Convertor which is present in 
  28. the STE.
  29.  
  30.      But  sequencers already exist,  so why make  another  ?  
  31.  
  32.     Well since  the Atari STE is very poorly supported (but it's 
  33. improving I'm pleased to see) I decided to have  a go at using some of 
  34. its extra custom hardware;  Typically its  DMA Stereo  sound.  Having 
  35. previously owned MASTER SOUND™ and seen  its primitive sequencing 
  36. system I though there was scope for a  bigger and better version. I 
  37. present SSSSS (conveniently alliterated).
  38.  
  39.      SO WHAT ?!
  40.  
  41.      The  major advantage of my system is not immediately  visible to 
  42. the user since the editor doesn't make use of it.  However when 
  43. incorporating  the sequences you have created with BASIC  it  will 
  44. become  obvious.  Ever  wanted a nice bit of sampled  music  in  a 
  45. program you have written ? NO - well skip this bit then.
  46.  
  47.                            YES - read on.
  48.  
  49.     And have you wanted it to be played in the background,  while you 
  50.  program is working ?  
  51.     
  52.     Look no further !  Not only is it easy (because  I've  done all 
  53. the hard work) but while  your  music  is playing  there is next to no 
  54. drain on the processor  at  all.
  55.  
  56. {    For those  who  know what's what:
  57.  
  58.     The routine which plays  the  sample sequence takes advantage of 
  59. the Vertical Blank Interrupt.  Counting interrupts between samples,  
  60. and starting each new sample after  an elapsed  time.  Since  it  uses 
  61. the DMA sound  chip  there  is  no processor  time taken up by playing 
  62. each sample,  with the  result that  the processor only really gets 
  63. called upon when a  different sample has to be played and even then it 
  64. probably doesn't notice ! }
  65.  
  66.  
  67.     (You can carry on reading now if you left me earlier !)
  68.  
  69. I will write any comments which I think may be useful to some, but on 
  70. the whole are NOT necessary for those who just want to use the package 
  71. in { } curly braces. I hope this helps cater for a wider audience.
  72.  
  73. How to use it and what you need.
  74. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  75.  
  76.     In order to make use of the sequencer you will :
  77.  
  78.     NOT need:- a midi instrument. 
  79.              It's not that kind of sequencer.
  80.  
  81.     NEED:- An Atari STE - it will crash on an STFM !!
  82.  
  83.         - A sound sampler, or access to sound samples.
  84.  
  85.         - to know what type of sample files your sound     sampler     
  86.           creates. 
  87.           Ie. Are they AVR files (Audio Visual Research) or raw (not 
  88.           headed). 
  89.           The sequencer will read AVR files directly. 
  90.           It will also read raw files - provided you use the 'head' 
  91.           function first and supply the file details. The head     
  92.           function will also alter the attributes of an existing AVR 
  93.           file.
  94.  
  95.         - sound samples that are either 6khz, 12khz, 25khz or 50khz. 
  96.           Approximately - these are the only frequencies    the STE     
  97.           will play. Other frequencies will be played at the wrong 
  98.           speed !
  99.  
  100.         - some patience and imagination.
  101.  
  102. The Screen Layout.
  103. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  104.  
  105.     At the top is the title and version details. Below this is a 
  106. large box which initially contains nothing. This is the main display 
  107. window. The buttons to the right of this control the display window. 
  108. There are two modes which the display window can be in : -
  109.  
  110.     Samples - mode. or
  111.     Sequence - mode.
  112.  
  113.     The current display mode is highlighted with an inverse video 
  114. button.
  115.  
  116.     Irrespective of mode, the main display contains two arrows. These 
  117. arrows are the cursor arrows and they point to one item in the display 
  118. (or none if there are no items in the display). It is THIS ITEM which 
  119. will have (individual item operations) operations performed on it.
  120.  
  121.     Below the main window to the left is the sequence control button 
  122. set. These are used to edit and manipulate your sequence. To the right 
  123. of this are the file handling controls and on the extreme right is the 
  124. info and exit buttons.
  125.  
  126. A Detailed Run-down.
  127. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  128.         FILE HANDLING CONTROLS:
  129.         ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  130.  
  131.         SEQ - SEQUENCE FILES.
  132.         ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  133.     These are the files used by the program to store the samples and 
  134. mixes.
  135.  
  136. A 'MIX AND SAMPLES' or 'ALL' file contains all of the sample data and 
  137. the mix information. When you save your finished work you should save 
  138. it using the 'ALL' option, as this contains all of the data required.
  139.  
  140. A 'MIX' file just contains the data for a mix. If you wish to make 
  141. alternative mixes of a 'MIX AND SAMPLES' file then you can do this and 
  142. just save the 'MIX ONLY'. A 'MIX ONLY' file is much smaller than a 
  143. 'MIX AND SAMPLES' file because it only holds the sample-play-order (or 
  144. key press) information for a mix. However a 'MIX ONLY' file canNOT 
  145. replace a 'MIX AND SAMPLES' file. And it should be noted that 'MIX 
  146. ONLY' files require the SAME 'MIX AND SAMPLES' file they were created 
  147. with to be of any use. 
  148.  
  149. *    LOAD - This gives the option to load an 'ALL' or 'MIX' file.
  150.  
  151. NOTE a mix file cannot be loaded if there are no samples present ie. 
  152. the 'MIX AND SAMPLES' file for the mix is not loaded in already. 
  153.  
  154. Loading a 'MIX AND SAMPLES' file clears everything currently in 
  155. memory!!
  156.  
  157. Loading a 'MIX ONLY' file clears only the mix, leaving the samples 
  158. intact!!
  159.  
  160. *    SAVE - This gives the same options as load.
  161.  
  162. Saving a 'MIX AND SAMPLES' file can ONLY be done if you have made a 
  163. mix - ie. there must be at least ONE item in the SEQUENCE listing (at 
  164. least one item displayed when the sequencer is in SEQUENCE mode).
  165.  
  166. Saving a 'MIX ONLY' - remember this does NOT save your samples, and so 
  167. is ONLY any use if you have a corresponding 'MIX AND SAMPLES' file !!!
  168.  
  169.  
  170.         SAM - SAMPLE FILES.
  171.         ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  172. The sample files which can be loaded using the SAMple LOAD option MUST 
  173. be in AUDIO VISUAL RESEARCH format !!! These files are usually created 
  174. with a *.AVR extension. If you are not sure whether your files are in 
  175. AVR format then simply try to load them - if it doesn't work then they 
  176. are not AVR samples !!
  177.  
  178. If you have RAW samples, that is ones without any header (most 
  179. samplers can save these !) then these can be loaded provided you 
  180. follow the instructions on how to HEAD a file first.
  181.  
  182. { NOTE there are two types of raw sample - signed and unsigned. This 
  183. status refers to whether the bytes in the sample go from 0 to 256 for 
  184. unsigned samples. Or -128 to 127 for signed samples. The STE can only 
  185. play signed samples, and so when an unsigned sample is loaded, it is 
  186. automatically signed. }
  187.  
  188. *    LOAD - Shows a file selector to allow you to load your samples. 
  189. Load will load any AVR file (signed or unsigned) - if the frequency of 
  190. the file is not recognized then your sample will be played at the 
  191. wrong frequency. The frequency of a file can be changed, if it is not 
  192. correct, by using the HEAD facility.
  193.  
  194. *    SAVE - Shows a file selector to allow you to save your samples.   
  195. The sequencer ONLY saves files in SIGNED AVR format. 
  196.  
  197. The sample which is saved is the one pointed to by the cursor-arrows, 
  198. when in SAMPLE mode.
  199.  
  200. { This can be useful if you have unsigned RAW or AVR files and you 
  201. wish to convert them to signed. The process can also be reversed if 
  202. you re-head a signed sample and say it is unsigned, lo